控制列表控件

路径：控件库 > 高级 > 控制列表

使用这些控件代表与特定过程相关的状态，并控制相应过程。

在新库中尚不可用（使用旧库可获取此控件）

有两种控制列表可用：

参数 说明
值

与控件的状态相对应的值。如果在值属性附加标签，则在加载控件时，状态将与标签值对齐。
状态 控件状态。控件以不同的背景颜色突出显示与其状态相关的项（请参阅控件属性中的“状态颜色”）。
选择

状态选择。所选项将在列表的左侧凸显一个小三角形。
写入模式

选择状态更新模式

  • 选择时写入：状态将自动更新，与光标位置对齐。
  • 键入时写入：仅当用户按下 Enter 键时，状态才会随光标位置更新
滚动条类型

选择表格的滚动模式

  • 手势：平移手势可用于平滑滚动表格。
  • 滚动条：使用滚动条滚动表格
只读

定义该列表是否仅是指示器。
列表数据

状态项列表。每个项都有一个状态名称，一个相应的值和一个标志，该标志使项显示在控件内。
定义状态

从列表数据属性添加/删除状态，即列表中的项目。

一个状态可以分配一个值。当您在选择时写入相关项（如果处于选择时写入模式）或通过按 Enter 键选择并确认项目（如果处于按 Enter 键时写入模式），则会将指定给该状态的值写入到与“控制列表”控件值相链接的标签。

 

通过 JavaScrip 代码管理列表数据项

可以在运行时使用 setProperty("listData", <NewControlList>) 从 JavaScript 代码修改数据项列表。以下示例显示了如何修改项的列表

function SetItemsList_btn_onMouseClick(me, eventInfo) { var NewControlList = [["OFF",100,true],["ON",101,true],["MAN",102,true],["AUTO",103,true]]; var ControListWgt = page.getWidget("controlListBtn.controlList"); ControListWgt.setProperty("listData", NewControlList); }

其中

- NewControlList 是带有项说明的数组
- controlListBtn.controlList 是要修改的控制列表控件的 ID

而 getProperty("listData") 仅返回用逗号分隔的仅包含名称的字符串。

function Read_btn_onMouseClick(me, eventInfo) { var ControListWgt = page.getWidget("controlListBtn.controlList"); var ListData = ControListWgt.getProperty("listData"); }

此处 ListData 的结果将为："OFF,ON,MAN,AUTO"

State

getProperty("state") 可用于检索S状态值。下列是 JavaScript 代码的示例

function controlListBtn_onDataUpdate(me, eventInfo) { var ControListWgt = page.getWidget("controlListBtn.controlList"); var State = ControListWgt.getProperty("state"); project.setTag("State", State); return false; }